Skip to content

docs: document roles on specific projects - #8450

Draft
mintlify[bot] wants to merge 5 commits into
mainfrom
autopilot/workos-site-roles
Draft

mintlify[bot] wants to merge 5 commits into
mainfrom
autopilot/workos-site-roles

Conversation

@mintlify

@mintlify mintlify Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Documents giving a member a different role on specific projects than their organization role, from the Edit access and permissions drawer on the Members page: a higher role, or No access to block them from a project. Includes matching notes on the Members page and the team instructions topic.

Based on merged dashboard and server changes that add per-project roles and the No access role. Draft because this may not be generally available yet; mark ready once it rolls out.

@mintlify mintlify Bot assigned ehcaw Nov 12, 2026
@mintlify
mintlify Bot requested a review from ehcaw November 12, 2026 23:58
@mintlify

mintlify Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Nov 13, 2026, 10:40 PM

@ethanpalm ethanpalm left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just a few small changes

Comment thread dashboard/members.mdx Outdated
1. Navigate to the [Members](https://app.mintlify.com/settings/organization/members) page of your dashboard.
2. In the member's row, select a new role from the **Role** dropdown. The change saves immediately.

If your organization can give members [roles on specific projects](/dashboard/roles#roles-on-specific-projects), you change roles from the member's actions menu instead: select **Edit role**.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If your organization can give members [roles on specific projects](/dashboard/roles#roles-on-specific-projects), you change roles from the member's actions menu instead: select **Edit role**.
If your organization can give members [roles on specific projects](/dashboard/roles#roles-on-specific-projects), you change roles from the member's actions menu instead. Select **Edit role** for the member whose role you want to adjust.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied, so it's two sentences now.

Comment thread dashboard/roles.mdx Outdated

## Roles on specific projects

If your organization has more than one project, you can give a member a higher role on specific projects than their organization role. For example, a viewer can be an editor on one project. A project role only raises access on that project. It never lowers access and doesn't apply to your other projects.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If your organization has more than one project, you can give a member a higher role on specific projects than their organization role. For example, a viewer can be an editor on one project. A project role only raises access on that project. It never lowers access and doesn't apply to your other projects.
If your organization has more than one project, you can give a member a role with more access on specific projects than their organization role. For example, a viewer in your organization can be an editor on one project. A project role only raises access on that project. It never lowers access and doesn't apply to your other projects.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied: "a role with more access" and "a viewer in your organization".

This branch was successfully deployed

1 active (outdated) deployment
staging — bc9228fa Deployed Nov 13, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants